home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / rnet200f.zip / UPGRADE.DOC < prev    next >
Text File  |  1993-06-02  |  9KB  |  173 lines
  1. -------------------------------------------------------------------------------
  2.                        Upgrading from RNET 1.xx to 2.00
  3. -------------------------------------------------------------------------------
  4.  
  5.    This document is here to tell you how to upgrade from an existing 1.xx
  6.    version of RNET to version 2.00.  Please read the entire thing so you know
  7.    what to expect and how to enable some of the new features.  Note that not
  8.    all features or functions are described -- that will have to wait for the
  9.    final documentation.
  10.  
  11.  (1)  Backup your existing RNET files (*.exe, *.cfg, etc).  You aren't likely
  12.       ever going to need the old files, but you'll be very unhappy if you do
  13.       need them and you didn't make a backup.  I recommend just making a quick
  14.       ZIP of the old files and putting it somewhere out of harms way.
  15.  
  16.  (2)  Put the new RNET.EXE where you want it (on the path or in \PCB or in a
  17.       RNET directory).  From the old files, you want to keep:
  18.  
  19.          MSGCOUNT.BIN  (keeps global counters)
  20.          <hostid>.CFG  (config file for each host)
  21.          <hostid>.PTR  (pointer file for each host)
  22.  
  23.  (3)  Using Qedit or TSE or whatever text editor you prefer, add the following
  24.       to the top of your <hostid>.CFG files:
  25.  
  26.          HOSTID=<hostid>      ; (8 char 'ID' of your HOST system)
  27.          LOCALID=<yourid>     ; (8 char 'ID' of YOUR system; for routing)
  28.          ROUTED=NO            ; (disable extended ORIGIN and SEENBY lines)
  29.  
  30.       In 1.xx, RNET used the <hostid> specified on the commandline to
  31.       determine the host name (for QWKs, REPs, and similar stuff).  The new
  32.       version of RNET allows you to call the .CFG anything you want and uses
  33.       the HOSTID= specified within the .CFG to determine the host name.
  34.  
  35.       The LOCALID= is used to tell RNET what your board's ID is in the mail
  36.       doors you have online.  It is needed by RNET version 2 for mail routing.
  37.       The specified id would be what someone would need to enter to have
  38.       messages routed to your system.  If you do not have a mail door id
  39.       already assigned to you, use the first 8 letters of your BBS name or
  40.       some other unique identification until you can contact me or the network
  41.       administration to get a unique id.
  42.  
  43.       The ROUTED=NO is used to disable the extended ORIGIN and SEENBY lines
  44.       used by RNET.  Use ROUTED=YES *when* the network you are echoing with
  45.       supports routed QWK mail.  Until QWK packet based routed mail is in use
  46.       on the network in question, there is no point (other than informative)
  47.       for those extended lines.  PCBoard 15.0 will "hide" those lines, but not
  48.       everyone is using PCBoard 15.0.
  49.  
  50.  (4)  If you use RNET= or QWIKMAIL= environment variables to point to a "home"
  51.       directory for RNET, make sure it is set.
  52.  
  53.       Also, you should set a PCBDAT= environment variable to the full filename
  54.       of your PCBOARD.DAT file. If you run RNET.EXE with no params, it will
  55.       tell you what the current settings are for the RNET= and PCBDAT=
  56.       environment variables.
  57.  
  58.       [added in 2.00f] - RNET will use the PCBDAT= environment to find the
  59.       directory or full filename of PCBOARD.DAT; then it will search the
  60.       current directory for PCBOARD.DAT; and finally, it will search the
  61.       entire DOS PATH= environment for PCBOARD.DAT.
  62.  
  63.  (5)  In order to convert your existing pointers (<hostid>.PTR) to the new
  64.       pointers (<hostid>.RPF), do a:  RNET EXPORT <hostid>.  When RNET needs
  65.       to create a new RPF file, it searches for an old PTR file to use for the
  66.       pointers.  If the old PTR file is not found, RNET will "top" the new
  67.       pointers.  Once you have a RPF file, you may delete your old PTR file.
  68.  
  69.       If, for some reason, RNET didn't see your .PTR file (likely from it not
  70.       being in the "home" directory pointed to by RNET= environment), set the
  71.       environment as needed or copy the .PTR file to the current directory,
  72.       delete the .RPF, and do another RNET EXPORT <hostid>.  You should get a
  73.       "notice" on the screen about "reading old pointer file...".
  74.  
  75.  (6)  Review the output placed in NOTICE.LOG, WARNING.LOG, and ERROR.LOG.
  76.       These files are created in the current or "home" directory.
  77.  
  78.          NOTICE.LOG    (things you should be aware of but aren't important)
  79.          WARNING.LOG   (things that are important but aren't critical)
  80.          ERROR.LOG     (something that caused RNET to fail--critical errors)
  81.  
  82.       Expect in NOTICE.LOG:
  83.  
  84.          List of conferences added to a new pointer file
  85.          List of old conference pointers read (and values therein)
  86.          List of conference messagebases created (if any were missing)
  87.  
  88.       Expect in WARNING.LOG:
  89.  
  90.         Warning about creating a new pointer file (hostid.RPF)
  91.         List of keywords "no longer supported" (yell if you need one of 'em)
  92.           (put a ; at the front of those keywords in the CFG to disable them)
  93.  
  94.       If ERROR.LOG exists:
  95.  
  96.         If it can't find PCBOARD.DAT, you need to set your PCBDAT= environ:
  97.            SET PCBDAT=C:\PCB\PCBOARD.DAT  (the full pathname of PCBOARD.DAT)
  98.  
  99.       Make any corrections or changes to your CFG files as recommended by the
  100.       logs.  A lot of information will show up in these logs the first time
  101.       RNET is run (since it is configuring all the conferences, reading the
  102.       old pointer file, and similar things).  You may delete any or all of
  103.       these logs when you have taken care of whatever they are warning you
  104.       about.
  105.  
  106.       Don't worry if you see a "used old style conference config" message as
  107.       you haven't had a chance to change to the newer style.  RNET will
  108.       continue to support the older style PRIVATE=, ANSI=, and similar
  109.       keywords as well as the new expanded CONF= statements.
  110.  
  111.  (7)  Add to your CFG: SWAPPATH=d:\dir\  (path where RNET can write swapfile)
  112.  
  113.       The SWAPPATH= keyword will tell RNET where it can put a swap file when a
  114.       shell'ed to program runs out of memory.  RNET will try using a shell
  115.       first -- if that fails (or an errorlevel is returned), it will swap
  116.       itself out of memory and try again.
  117.  
  118.       Do *NOT* use the same temp directory for swapping that you use for
  119.       uncompressing/compressing packets.  If you do, PKZIP may end up
  120.       trashing your .REP and the swap file (likely resulting in a lockup).
  121.  
  122.       If SWAPPATH= is not specified, RNET will use the current directory.
  123.  
  124.  (8)  If running PKZIP version 2, check your COMPRESS= statement.  If it
  125.       contains a "-m", *remove it*.  The new version of PKZIP uses -m
  126.       differently than the old version in that it *deletes* the working
  127.       directory when it is done.  I consider this a bug in PKZIP, but PKware
  128.       thinks it's a feature... go figure.
  129.  
  130. -------------------------------------------------------------------------------
  131.                    Optional Things (enabling new features)
  132. -------------------------------------------------------------------------------
  133.  
  134.  (A)  RNET uses the colors you have defined for PCBSM.  If you want to
  135.       customize the display colors: (a) Make a backup of PCBSM.CLR; (b) use
  136.       PCBSM.EXE to change the colors as desired; (c) copy the new PCBSM.CLR to
  137.       the RNET directory and/or rename it to RNET.CLR; (d) restore your
  138.       origional PCBSM.CLR.
  139.  
  140.  (B)  To turn on "you have mail waiting" flags for users, add:
  141.  
  142.         YOURMAIL=YES        ; (enable 'you have mail waiting' flag updates)
  143.  
  144.  (C)  To turn on automatic backing up of QWK, REP and RPF files, use:
  145.  
  146.         KEEPPATH=d:\dir\    ; (location for backup QWK, REP, RPF files)
  147.         KEEPQWKS=5          ; (number of QWK packets to keep in backup dir)
  148.         KEEPREPS=5          ; (number of REP packets to keep in backup dir)
  149.         KEEPRPFS=5          ; (number of RPF files to keep in backup dir)
  150.  
  151.       Disable any of these by specifing zero (0).  Max is currently 9.
  152.       Default KEEPPATH= is "keep\" under the current directory.
  153.  
  154.  (D)  To change the default AGE limit for messages from 30 days, use:
  155.  
  156.         AGELIMIT=15         ; (max age in days of messages allowed)
  157.  
  158.  (E)  To enable refer-number support and host dup checking, use:
  159.  
  160.         REFER=YES           ; (enable REFER number support & dup checking)
  161.         CHECK_NUMBERS=YES   ; (enable dup check of host message numbers)
  162.  
  163.  (F)  To enable CRC32 dup checking:
  164.  
  165.         CHECK_CRC=YES       ; (enable X.25 CRC32 dup ck; requires REFER=YES!)
  166.  
  167.  (G)  (see RNETPACK.DOC for instructions on enabling RNET's packing support)
  168.  
  169.    To play with the other new features, refer to RNET_REF.DOC until RNET.DOC
  170.    is finished.
  171.  
  172. -------------------------------------------------------------------------------
  173.